Ako pridat Asyntai AI chatbota do Backdrop CMS

Návod krok za krokom pre webové stránky Backdrop CMS

Platforma:

Krok 1: Získajte svoj vkladací kód

Najprv prejdite na svoj Asyntai Dashboard a prejdite nadol k sekcii „Vkladací kód“. Skopírujte svoj jedinečný vkladací kód, ktorý bude vyzerať takto:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Poznámka: Kód vyššie je len príklad. Musíte skopírovať svoj vlastný jedinečný vkladací kód zo svojho Dashboardu, pretože obsahuje vaše osobné ID widgetu.

Krok 2: Pridanie do šablóny temy (odporúčané)

Backdrop CMS používa súbory šablón .tpl.php vo svojich témach. Odporúčaný prístup je pridať vkladací kód priamo do šablóny stránky vašej aktívnej témy:

Prístupte k svojej inštalácii Backdrop CMS cez FTP alebo Správcu súborov
Prejdite do priečinka vašej aktívnej témy: themes/yourtheme/
Otvorte súbor page.tpl.php (alebo layout.tpl.php v zavislosti od vasej temy)
Nájdite uzatvárací tag </body> alebo riadok <?php print $page_bottom; ?>
Vložte svoj vkladací kód Asyntai tesne pred tento riadok
Uložte súbor

<!-- Asyntai AI Chatbot -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
<?php print $page_bottom; ?>
</body>

Tip: Umiestnenie kódu tesne pred <?php print $page_bottom; ?> alebo uzatvárací tag </body> zabezpečí, že sa chatbot načíta po obsahu stránky, čo poskytuje lepší výkon načítania stránky. Táto metóda automaticky pridá chatbota na každú stránku používajúcu túto tému.

Alternatívna metóda 1: Použitie vlastného modulu

Môžete vytvoriť jednoduchý modul Backdrop CMS, ktorý vloží skript chatbota pomocou backdrop_add_js():

Vytvorte priečinok modulu: modules/custom/asyntai_widget/
Vytvorte súbor modulu asyntai_widget.module s nasledujúcim kódom:
// modules/custom/asyntai_widget/asyntai_widget.module function asyntai_widget_init() { backdrop_add_js('https://asyntai.com/static/js/chat-widget.js', array( 'type' => 'external', 'scope' => 'footer', 'attributes' => array('async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID'), )); }
Vytvorte súbor asyntai_widget.info:
name = Asyntai AI Chatbot Widget description = Adds the Asyntai AI chatbot widget to all pages. backdrop = 1.x package = Custom type = module
Prejdite na Funkcionalita (admin/modules) vo vasom administracnom paneli Backdrop
Nájdite \"Asyntai AI Chatbot Widget\" v balíku Custom a povoľte ho
Kliknite na \"Save configuration\"

Poznámka: Nahraďte YOUR_WIDGET_ID v kóde modulu vaším skutočným ID widgetu z Asyntai Dashboardu. Prístup s vlastným modulom je bezpečný pri aktualizáciách a nebude prepísaný pri aktualizácii vašej témy.

Alternatívna metóda 2: Použitie modulu \"Add to Head\" od Backdrop

Prispievateľský modul \"Add to Head\" poskytuje jednoduchý spôsob vkladania skriptov bez úpravy kódu:

Stiahnite a nainštalujte prispievateľský modul \"Add to Head\" z webu Backdrop CMS
Prejdite na Konfigurácia > Vývoj > Add to Head
Pridajte svoj vkladací kód Asyntai v sekcii päty
Kliknite na \"Save configuration\"

Tip: Použitie modulu \"Add to Head\" je najjednoduchšia metóda, ak nechcete upravovať súbory témy ani vytvárať vlastné moduly. Poskytuje jednoduché administračné rozhranie na správu vložených skriptov.

Alternatívna metóda 3: Použitie systému blokov

Systém rozvrhnutia a blokov Backdrop CMS možno tiež použiť na pridanie chatbota:

Prihláste sa do svojho administračného panelu Backdrop CMS
Prejdite na Štruktúra > Rozvrhnutia
Vyberte rozvrhnutie, ktoré chcete upraviť (napr. predvolené rozvrhnutie)
Kliknite na \"Add block\" v oblasti päty
Vyberte "Vlastný blok"
Nastavte formát bloku na \"Full HTML\" alebo \"Raw HTML\"
Vložte svoj vkladací kód Asyntai do tela bloku
Dajte bloku názov (napr. \"Asyntai Chatbot\") a voliteľne zaškrtnite \"Hide title\"
Kliknite na \"Save block\" a potom \"Save layout\"

Dôležité: Uistite sa, že formát textu je nastavený na \"Full HTML\" alebo \"Raw HTML\", aby nebol tag skriptu odstránený. Predvolený formát \"Filtered HTML\" odstráni tagy skriptov z bezpečnostných dôvodov.

Krok 3: Vymazanie vyrovnávacej pamäte a overenie

Po vykonaní zmien vymažte vyrovnávaciu pamäť Backdrop CMS a overte inštaláciu:

Prejdite na Konfigurácia > Výkon vo vašom administračnom paneli
Kliknite na \"Clear all caches\"
Otvorte svoju webovú stránku v novej záložke prehliadača alebo v okne inkognito
Mali by ste vidieť tlačidlo chatového widgetu v pravom dolnom rohu
Kliknite naň, aby ste sa uistili, že sa otvára a funguje správne

Nevidíte widget? Uistite sa, že ste vymazali vyrovnávaciu pamäť Backdrop CMS v Konfigurácia > Výkon. Skúste zobraziť svoj web v okne inkognito alebo vyčistite vyrovnávaciu pamäť prehliadača. Otvorte konzolu prehliadača (F12) a skontrolujte prípadné chyby JavaScriptu. Ak ste použili metódu s vlastným modulom, overte, že je modul povolený v Funkcionalita.